Migrated the installer prompts from 'laravel/prompts' to 'alexskrypnyk/prompty' and declared them as 1 Prompty flow chain. - #3281

Summary

The installer asks its questions through alexskrypnyk/prompty, required as a normal Composer library and bundled into installer.phar by Box from vendor/. PromptManager::runPrompts() declares the whole flow as 1 Prompty::flow() chain: a ->section() per heading, an ->add() per handler, and ->children() / ->end() around the prompts that depend on another answer. The chain holds structure only. Each handler is a Prompty step, so its shouldRun() decides whether it's asked and its label, options and default decide what it shows. Tui and Task draw their notes, summary table, boxes, tasks and "Press any key" pause with Prompty's note(), table(), box(), task() and pause().

laravel/prompts needed patches/laravel-prompts.patch, a 1300-line patch re-rolled on every upstream bump, for descriptions and test-time validation. Around it, the installer kept its own terminal UI: Tui copied Laravel's note and table renderers, Task drew spinners and result lines with hard-coded "cursor up 5 rows" sequences, TaskOutput dimmed streamed output, and getChar() called stty itself. In non-interactive mode, Laravel also returned a select default that wasn't one of the options, so code_provider_other installed GitHub Actions for a repository that isn't on GitHub.

After merge, the installer draws 1 tree from the welcome box to the last task, with dependent prompts nested under the answer they depend on, long lines wrapped inside the tree and Ctrl+U stepping back to the previous prompt. Each prompt can be answered by VORTEX_INSTALLER_PROMPT_<ID>, which wins over --prompts, discovery and handler defaults, except for the profile, theme and web root values the installer resolves itself. A non-interactive "other" code provider now gets CircleCI, the same answer an interactive run gives. Handler classes keep their methods, and --prompts, --schema and the processing order are untouched.

Before / After

BEFORE                                     AFTER
──────                                     ─────
PromptManager::runPrompts()                PromptManager::runPrompts()
  form()                                     Prompty::flow()
    ->add(fn => prompt(Name::class))           ->section('Drupal')
    ->addIf(fn => shouldRun(...), ...)           ->add($h[Theme::id()])
  label() adds "(n/42)" itself                     ->children()
  validator() wraps "Required."                      ->add($h[ThemeCustom::id()])
  reorders multiselect answers                     ->end()
  │                                            ->run(numbering: 'total',
  ▼                                              env_prefix: 'VORTEX_INSTALLER_PROMPT_')
laravel/prompts + 1300-line patch            │
                                             ▼
                                           handler = PromptyStepInterface
                                             condition()  -> shouldRun()
                                             arguments()  -> label, options, default
                                           vendor/alexskrypnyk/prompty (no patch)

Tui                                        Tui
  info/note/success/error: Laravel           Prompty::note()
    note renderer copied by hand
  box/table/list: Symfony Table +            Prompty::box() / Prompty::table()
    Laravel table style copied by hand
  getChar(): stty cbreak + fgetc             Prompty::pause()
  normalizeText/utfPadding/caret*            (removed, Prompty measures width)

Task::action()                             Task::action()
  spin(): static frame + erase               Prompty::task()
  label(): "cursor up 5" sequences             spinner, hint, result line
  streaming: TaskOutput + ob_start             stream: TRUE

Changes

Dependencies

• alexskrypnyk/prompty is required at dev-main through a VCS repository entry, because the package isn't on Packagist yet. Pin it to a release and drop the repositories entry once one is published.
• Removed laravel/prompts, cweagans/composer-patches, mockery/mockery, patches/laravel-prompts.patch, patches/reroot-patch.php and patches.lock.json.

Prompts

• HandlerInterface extends PromptyStepInterface. AbstractHandler implements it: key() is the handler ID, widget() is the type() value, condition() is shouldRun(), and arguments() builds the widget arguments from the handler's own methods.
• arguments() passes required, help (from hint()), description, scroll and, for a multiselect, order: 'default', so a discovered .env list keeps its order. The default comes from --prompts, then discovery, then the handler default, and a default outside the options is dropped before the widget call, as Prompty recommends for defaults read from a project.
• A profile, theme or web root value the handler resolves answers its step through discovered:, and is added to the options when it isn't 1 of them.
• --prompts values reach each handler through setOverride().
• Every handler now receives the answers collected so far, where some were called with none. That turns on a rule Services::options() already had: Solr is offered only when the search module is selected or Solr is already in the project. The custom_modules_no_search and custom_modules_none fixtures no longer install Solr.
• Skipped prompts answer NULL, so handlers that read $responses[...] directly see the same keys as before.
• PromptType lists Prompty's 5 widget names. The 6 Laravel-only cases had no handler using them and are removed.
• runPrompts() returns FALSE when the user cancels, and InstallCommand aborts with Aborting project installation. No files were changed. and exit code 1.

Output and tasks

• Tui::init() configures Prompty once per command: Unicode, ANSI from isDecorated(), interactive from --no-interaction, placeholder_fallback: FALSE, OK and FAILED result labels, and an output callback to the command's output.
• Task::action() runs Prompty::task(). A streamed task points Tui::output() at php://output for its action, so build output written through the console runners is captured under the task.
• Prompty draws 1 task at a time, and the build runs nested commands (install, then build, then check-requirements) inside a streamed task. While a streamed task's action runs, Tui and nested Task::action() calls write plain lines that the outer task draws, and a nested Tui::init() leaves Prompty's output alone.
• Removed TaskOutput, Tui::getChar(), normalizeText(), utfPadding() and the caret helpers.

Tests

• TuiTrait::tuiInput() feeds keystrokes with promptyInput() and turns on promptyThrowOnInvalid(). Handler tests use self::KEY_* constants.
• Laravel's faked terminal repeated the last keystroke past the end of the input, which hid 9 discovery data sets that sent 1 keystroke too few. They now send it explicitly.
• TuiTest checks what Tui still owns, rather than Prompty's exact borders, and covers the captured mode. TaskTest covers a task nested in a streamed task.
• Regenerated the code_provider_other handler-process fixture for the CircleCI answer, and the 2 no-search fixtures for Solr.

Video and docs

• The installer video is re-recorded with the nested prompts. Its expect script answers each prompt when it sees the active ◇ symbol followed by a (n) or (n.m) step number, matched with UTF-8 decoding, because a flow hides the cursor once rather than per widget.
• installer.mdx links Prompty and documents VORTEX_INSTALLER_PROMPT_<ID>, and the installer CLAUDE.md drops the patch re-roll section and describes the runPrompts() chain.

Screenshots

The theme prompts nested under the Theme answer, with the step total running alongside:

Database source nested under Provision type, followed by the next section:

Verification

• composer test in .vortex/installer ran 1677 tests, including PharTest, which builds installer.phar with Box and installs from it. The only 2 failures were the no-search handler-process fixtures, which ahoy update-snapshots then regenerated. CI runs the installer suite green on the final commit. composer lint passes.
• ahoy update-videos installer recorded the full interactive run with the nested prompts: it typed the site and organization names, accepted every other default, installed the project and declined the build, with no errors, warnings or failures in the transcript.